Introduction

The Database ARchive format is the central concept of the Darrt library. The basic DAR file uses the ZIP and the ZLIB compression format so it may be created with any of number of common tools such as jar from the Java SDK, one of the Windows graphical Zip programs or the Ant Task which is part of the library. The extension .dar is not mandatory but is suggested to quickly identify files of this type.

The internal directory structure of the .dar file is as follows:

Dir / File Mandatory? Comment
META-INF/schema.xml Yes Describes the database according to the darrt-schema.xsd
data/*.xml No XML format files of data. Each file name should match the table to insert the data into. XML should conform tho the darrt-data.xsd
data/*.csv No Comma separated files of data. Each file name should match the table to insert the data into.
procs/ & lt;rdbms & gt;/*.sql No Stored procedure or function creation scripts. These are not database independent so the .dar creator must place them in the subdirectory matching the target RDBMS for Darrt to attempt to create them. Darrt does not understand the various mechanisms for creating procedures or their syntax, it will simply attempt to run the script.